<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
  <head>
    <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
    <meta http-equiv="Content-Style-Type" content="text/css">
    <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css">
    <title>Working with memory monitors</title>
  </head>
  
<body>

<h1>Working with memory monitors</h1>

  <p>To view the contents of memory from the Memory view:</p>

  <ol>
    <li>In the <strong>Monitors</strong> pane, select the memory monitor that contains the memory location that you want to view. Memory will appear in the <strong>Renderings</strong> pane, where you will perform all other steps. If you have added multiple renderings, select the tab that contains the rendering that you want to view.</li>
    <li>If desired, split the <strong>Renderings</strong> pane by selecting the <strong>Toggle Split Pane</strong> push button (<img src="images/task-memory-det-pane.gif" alt="Toggle Split Pane push button">). By default, the Memory view only displays one rendering pane. When you click <strong>Toggle Split Pane</strong>, a second rendering opens and displays as a split pane.</li>
    <li>If necessary, use the scroll bar in the rendering to view memory locations above or below the base address of the memory monitor being shown by the current rendering. Alternatively, you can right-click in the rendering and choose the <strong>Go to Address</strong> pop-up menu item or hit Ctrl+G. This will open a section at the bottom of the rendering, in which you can perform the following actions:
      <ul>
        <li>Select the <strong>Go to Address</strong> pull-down menu item and then enter an address that you want to jump to. The rendering will be positioned so that the address entered is visible and selected.</li>
        <li>Select the <strong>Go to Offset</strong> pull-down menu item and then enter the offset. The rendering will be positioned so that the address of the expression (base address), plus the offset entered, is visible and selected. A negative value will position the rendering back from the base address.</li>
        <li>Select the <strong>Jump Memory Units</strong> pull-down menu item. This function takes the currently-selected address and adds the number of memory units that you specify to it. The resulting address is selected. A negative value will position the rendering back from the current address.</li>
      </ul>
      <p>For all of these entries, you can input them as HEX by selecting the <strong>Input as Hex</strong> check box (if this check box is not selected, input will be decimal). Once you have made the entry in the field, hit Enter or click <strong>OK</strong> to go to the location in the rendering. To close this section, click <strong>Cancel</strong> or hit Ctrl+G.</p>
      <p><strong>Note:</strong> Input is also treated as HEX if it is prefixed with <code>0x</code>.</p>
    </li>
    <li>If you want, change the width of any column by clicking the left or right side of its header cell and dragging it to alter the width of the column - or right-click inside the rendering and select <strong>Resize to Fit</strong> from the pop-up menu so that all columns are re-sized so that all text within them can be viewed. Alternatively, you can right-click inside the rendering and select <strong>Format</strong> from the pop-up menu. This will open the Format dialog box. In this dialog box, you can set the number of units per row and the number of units per column. As you make these settings, a <strong>Preview</strong> window in the dialog box displays the rendering layout that you are setting. To save these settings as the default layout, click <strong>Save as Defaults</strong>.</li>
    <li>You can also hide elements of the Memory view for easier viewing:
      <ul>
        <li>You can hide the <strong>Monitors</strong> pane by deselecting the <strong>Toggle Memory Monitors Pane</strong> toggle.</li>
        <li>You can hide the <strong>Address</strong> column by right-clicking inside the rendering and selecting <strong>Hide Address Column</strong>. To restore a the address column when it is hidden, right-click inside the rendering and select <strong>Show Address Column</strong> from the pop-up menu.</li>
      </ul>
    </li>
  </ol>

  <p>If you are in a memory rendering and move away from the address that you originally set to monitor, choosing the <strong>Reset to Base Address</strong> pop-up menu item will position the cursor back to the base address of the memory monitor. Alternatively, you can reset all renderings for a memory monitor by right-clicking the monitor and selecting <strong>Reset</strong> (or, you can select multiple monitors and choose this action). When you reset a monitor, by default, the visible renderings will be reset to the base address. To reset all renderings in the current Memory view to the base address, modify the Memory view preferences.</p>

</body>
</html>
